<topicVersion>
  <topicName>LynxWikiInstallationNotes</topicName>
  <wikiDir>WikiRoot\WikiDir</wikiDir>
  <creator>jwd</creator>
  <createdOn>2013-03-06T02:04:57.503</createdOn>
  <version>3</version>
  <editReason />
  <wikiText>!!""LynxWiki"" Download


!!Create Virtual Directory

        1. Create a physical path to hold the Virtual Directory you will create in the next step
                1. I use: *""C:\VirtualDir\LynxWiki""*
        1. In IIS Manager create a Virtual Directory below the Default or Main Web site called """LynxWiki""" and assigned it to the physical path previously created.

!!Create ""LynxWiki"" ""AppPool""

        1. Create the application pool to be used by ""LynxWiki""
                1. Enable 32-Bit Applications should be set to *True*
                        1. The application uses highly complex regular expressions that when run in 32-bit process require milliseconds, but when run in 64-bit processes take between 30 and 80 seconds to complete
                1. The Identity should remain at *""ApplicationPoolIdentity""*
                1. Idle time-out (minutes) should be set to *1220* 
                        1. The ""ParserEngine"" is a singleton and takes 2-3 seconds to initialize. Using this setting minimizes how often it must be created.
[image:/LynxWiki/Attachments/upload/images/AppPoolSettings.png]

!!Move Download to Virtual Directory

        1. Unzip the contents of the download file into the physical path created for the Virtual Directory.
        1. Inspect the contents of the Virtual Directory in IIS Manager. It should appear as below
[image:/LynxWiki/Attachments/upload/images/VirtualDir.png]

!!Configure Attachment Directory Security

        1. In a Windows File Explorer open the Security Permissions Property for the Attachments Folder
        1. Select Edit and then Add
        1. In the Select Users or Groups dialog enter *""IIS AppPool\LynxWiki""*
                1. Note that this is a special user not locatable in the Advanced User dialog

[image:/LynxWiki/Attachments/upload/images/AddLynxWikiSecurity.png]
        1. After clicking OK in the Select Users or Groups dialog ensure that the permissions are checked for the *""LynxWiki""* user as shown in the Permissions dialog below

[image:/LynxWiki/Attachments/upload/images/AttachmentFldSecurity.png]
        1. It is not necessary to change any settings in for the upload directory, but the security dialog for that directory shows inherited special permissions for the *""LynxWiki""* user
[image:/LynxWiki/Attachments/upload/images/Uploadfld.png]
        1. Those special permissions above result in the Advanced security settings show for the user in the upload directory below.
[image:/LynxWiki/Attachments/upload/images/AdvUploadSec.png]
        1. It is necessary to change permissions for the docs, images and misc directory
                1. Open the Advances Security Settings dialog and click Change Permissions.
                1. The dialog changes and includes 2 checkboxes and 3 buttons
                        1. ensure the checkboxes are unchecked and press Edit...
                        1. In the Windows Security dialog press Add to convert inherited permissions to explicit permissions

[image:/LynxWiki/Attachments/upload/images/ClearInheritedSecurity.png]

        1. The Advanced Security Settings dialog will now show as being *not inherited*
        1. There may be multiple entries for the ""LynxWiki"" user based on different permissions or scope

[image:/LynxWiki/Attachments/upload/images/AdvancedSettingsImageFld.png]

        1. Edit each entry for the user ""LynxWiki"" so that they are the same as the dialog below 
        1. When all entries are the same they will be combined into a single entry with a scope of *This folder, subfolders and files*
                1. Ensure the checkbox for *Traverse folder / execute file* is unchecked
[image:/LynxWiki/Attachments/upload/images/SpecialDocsFld.png]


!!Configure User Database
        1. The User database is not included in the release as it is auto-generated by the application on first startup.
        1. It is necessary to edit the *""DataSource""*  of the *""DefaultConnection""* in the web.config file so that it points to the correct Sql locator for the server
        1. Do not change the *""AttachDbFilename""*, of the *""InitialCatalog""* values
        1. Update the Authentication Settings in IIS Manager so that they match the dialog below

[image:/LynxWiki/Attachments/upload/images/AuthenticationSetting.png]

!!Other Configuration Steps
        1. Update the Output Caching settings to match the entries below
[image:/LynxWiki/Attachments/upload/images/OutputCaching.png]

</wikiText>
  <body>&lt;WomDocument&gt;
&lt;BaseTopic&gt;http://www.sapientier.com:88/LynxWiki/WikiTopic/Index&lt;/BaseTopic&gt;
&lt;BaseEdit&gt;http://www.sapientier.com:88/LynxWiki/WikiTopic/Page&lt;/BaseEdit&gt;
&lt;BaseImage&gt;http://www.sapientier.com:88/LynxWiki/images/&lt;/BaseImage&gt;
&lt;SiteUrl&gt;http://www.sapientier.com:88/LynxWiki/&lt;/SiteUrl&gt;
&lt;InputDoc&gt;&lt;/InputDoc&gt;
&lt;Header level="2"&gt;
&lt;EscapedNoFormatText&gt;LynxWiki&lt;/EscapedNoFormatText&gt;&lt;womHeaderText&gt; Download&lt;/womHeaderText&gt;&lt;AnchorText&gt;_1__Download&lt;/AnchorText&gt;&lt;/Header&gt;&lt;Header level="2"&gt;
&lt;womHeaderText&gt;Create Virtual Directory&lt;/womHeaderText&gt;&lt;AnchorText&gt;_2_Create_Virtual_Directory&lt;/AnchorText&gt;&lt;/Header&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; Create a physical path to hold the Virtual Directory you will create in the next step&lt;/womListText&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; I use: &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;EscapedNoFormatText&gt;C:\VirtualDir\LynxWiki&lt;/EscapedNoFormatText&gt;&lt;/TextileStrong&gt;&lt;/item&gt;
&lt;/list&gt;&lt;/item&gt;
&lt;item&gt;
&lt;womListText&gt; In IIS Manager create a Virtual Directory below the Default or Main Web site called &lt;/womListText&gt;&lt;EscapedNoFormatText&gt;"LynxWiki&lt;/EscapedNoFormatText&gt;&lt;womListText&gt;" and assigned it to the physical path previously created.&lt;/womListText&gt;&lt;/item&gt;&lt;/list&gt;
&lt;Header level="2"&gt;
&lt;womHeaderText&gt;Create &lt;/womHeaderText&gt;&lt;AnchorText&gt;_3_Create_&lt;/AnchorText&gt;&lt;EscapedNoFormatText&gt;LynxWiki&lt;/EscapedNoFormatText&gt;&lt;womHeaderText&gt; &lt;/womHeaderText&gt;&lt;AnchorText&gt;_4__&lt;/AnchorText&gt;&lt;EscapedNoFormatText&gt;AppPool&lt;/EscapedNoFormatText&gt;&lt;/Header&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; Create the application pool to be used by &lt;/womListText&gt;&lt;EscapedNoFormatText&gt;LynxWiki&lt;/EscapedNoFormatText&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; Enable 32-Bit Applications should be set to &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;womStrongText&gt;True&lt;/womStrongText&gt;&lt;/TextileStrong&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; The application uses highly complex regular expressions that when run in 32-bit process require milliseconds, but when run in 64-bit processes take between 30 and 80 seconds to complete&lt;/womListText&gt;&lt;/item&gt;
&lt;/list&gt;&lt;/item&gt;
&lt;item&gt;
&lt;womListText&gt; The Identity should remain at &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;EscapedNoFormatText&gt;ApplicationPoolIdentity&lt;/EscapedNoFormatText&gt;&lt;/TextileStrong&gt;&lt;/item&gt;
&lt;item&gt;
&lt;womListText&gt; Idle time-out (minutes) should be set to &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;womStrongText&gt;1220&lt;/womStrongText&gt;&lt;/TextileStrong&gt;&lt;womListText&gt; &lt;/womListText&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; The &lt;/womListText&gt;&lt;EscapedNoFormatText&gt;ParserEngine&lt;/EscapedNoFormatText&gt;&lt;womListText&gt; is a singleton and takes 2-3 seconds to initialize. Using this setting minimizes how often it must be created.&lt;/womListText&gt;&lt;/item&gt;&lt;/list&gt;
&lt;/item&gt;&lt;/list&gt;
&lt;/item&gt;&lt;/list&gt;

&lt;Para&gt;&lt;WikiImage&gt;/LynxWiki/Attachments/upload/images/AppPoolSettings.png&lt;/WikiImage&gt;&lt;/Para&gt;
&lt;Header level="2"&gt;
&lt;womHeaderText&gt;Move Download to Virtual Directory&lt;/womHeaderText&gt;&lt;AnchorText&gt;_5_Move_Download_to_Virtual_Directory&lt;/AnchorText&gt;&lt;/Header&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; Unzip the contents of the download file into the physical path created for the Virtual Directory.&lt;/womListText&gt;&lt;/item&gt;
&lt;item&gt;
&lt;womListText&gt; Inspect the contents of the Virtual Directory in IIS Manager. It should appear as below&lt;/womListText&gt;&lt;/item&gt;&lt;/list&gt;

&lt;Para&gt;&lt;WikiImage&gt;/LynxWiki/Attachments/upload/images/VirtualDir.png&lt;/WikiImage&gt;&lt;/Para&gt;
&lt;Header level="2"&gt;
&lt;womHeaderText&gt;Configure Attachment Directory Security&lt;/womHeaderText&gt;&lt;AnchorText&gt;_6_Configure_Attachment_Directory_Security&lt;/AnchorText&gt;&lt;/Header&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; In a Windows File Explorer open the Security Permissions Property for the Attachments Folder&lt;/womListText&gt;&lt;/item&gt;
&lt;item&gt;
&lt;womListText&gt; Select Edit and then Add&lt;/womListText&gt;&lt;/item&gt;
&lt;item&gt;
&lt;womListText&gt; In the Select Users or Groups dialog enter &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;EscapedNoFormatText&gt;IIS AppPool\LynxWiki&lt;/EscapedNoFormatText&gt;&lt;/TextileStrong&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; Note that this is a special user not locatable in the Advanced User dialog&lt;/womListText&gt;&lt;/item&gt;&lt;/list&gt;
&lt;/item&gt;&lt;/list&gt;

&lt;Para&gt;&lt;WikiImage&gt;/LynxWiki/Attachments/upload/images/AddLynxWikiSecurity.png&lt;/WikiImage&gt;&lt;/Para&gt;
&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; After clicking OK in the Select Users or Groups dialog ensure that the permissions are checked for the &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;EscapedNoFormatText&gt;LynxWiki&lt;/EscapedNoFormatText&gt;&lt;/TextileStrong&gt;&lt;womListText&gt; user as shown in the Permissions dialog below&lt;/womListText&gt;&lt;/item&gt;&lt;/list&gt;

&lt;Para&gt;&lt;WikiImage&gt;/LynxWiki/Attachments/upload/images/AttachmentFldSecurity.png&lt;/WikiImage&gt;&lt;/Para&gt;
&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; It is not necessary to change any settings in for the upload directory, but the security dialog for that directory shows inherited special permissions for the &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;EscapedNoFormatText&gt;LynxWiki&lt;/EscapedNoFormatText&gt;&lt;/TextileStrong&gt;&lt;womListText&gt; user&lt;/womListText&gt;&lt;/item&gt;&lt;/list&gt;

&lt;Para&gt;&lt;WikiImage&gt;/LynxWiki/Attachments/upload/images/Uploadfld.png&lt;/WikiImage&gt;&lt;/Para&gt;
&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; Those special permissions above result in the Advanced security settings show for the user in the upload directory below.&lt;/womListText&gt;&lt;/item&gt;&lt;/list&gt;

&lt;Para&gt;&lt;WikiImage&gt;/LynxWiki/Attachments/upload/images/AdvUploadSec.png&lt;/WikiImage&gt;&lt;/Para&gt;
&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; It is necessary to change permissions for the docs, images and misc directory&lt;/womListText&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; Open the Advances Security Settings dialog and click Change Permissions.&lt;/womListText&gt;&lt;/item&gt;
&lt;item&gt;
&lt;womListText&gt; The dialog changes and includes 2 checkboxes and 3 buttons&lt;/womListText&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; ensure the checkboxes are unchecked and press Edit...&lt;/womListText&gt;&lt;/item&gt;
&lt;item&gt;
&lt;womListText&gt; In the Windows Security dialog press Add to convert inherited permissions to explicit permissions&lt;/womListText&gt;&lt;/item&gt;&lt;/list&gt;
&lt;/item&gt;&lt;/list&gt;
&lt;/item&gt;&lt;/list&gt;

&lt;Para&gt;&lt;WikiImage&gt;/LynxWiki/Attachments/upload/images/ClearInheritedSecurity.png&lt;/WikiImage&gt;&lt;/Para&gt;
&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; The Advanced Security Settings dialog will now show as being &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;womStrongText&gt;not inherited&lt;/womStrongText&gt;&lt;/TextileStrong&gt;&lt;/item&gt;
&lt;item&gt;
&lt;womListText&gt; There may be multiple entries for the &lt;/womListText&gt;&lt;EscapedNoFormatText&gt;LynxWiki&lt;/EscapedNoFormatText&gt;&lt;womListText&gt; user based on different permissions or scope&lt;/womListText&gt;&lt;/item&gt;&lt;/list&gt;

&lt;Para&gt;&lt;WikiImage&gt;/LynxWiki/Attachments/upload/images/AdvancedSettingsImageFld.png&lt;/WikiImage&gt;&lt;/Para&gt;
&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; Edit each entry for the user &lt;/womListText&gt;&lt;EscapedNoFormatText&gt;LynxWiki&lt;/EscapedNoFormatText&gt;&lt;womListText&gt; so that they are the same as the dialog below &lt;/womListText&gt;&lt;/item&gt;
&lt;item&gt;
&lt;womListText&gt; When all entries are the same they will be combined into a single entry with a scope of &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;womStrongText&gt;This folder, subfolders and files&lt;/womStrongText&gt;&lt;/TextileStrong&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; Ensure the checkbox for &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;womStrongText&gt;Traverse folder / execute file&lt;/womStrongText&gt;&lt;/TextileStrong&gt;&lt;womListText&gt; is unchecked&lt;/womListText&gt;&lt;/item&gt;&lt;/list&gt;
&lt;/item&gt;&lt;/list&gt;

&lt;Para&gt;&lt;WikiImage&gt;/LynxWiki/Attachments/upload/images/SpecialDocsFld.png&lt;/WikiImage&gt;&lt;/Para&gt;
&lt;Header level="2"&gt;
&lt;womHeaderText&gt;Configure User Database&lt;/womHeaderText&gt;&lt;AnchorText&gt;_7_Configure_User_Database&lt;/AnchorText&gt;&lt;/Header&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; The User database is not included in the release as it is auto-generated by the application on first startup.&lt;/womListText&gt;&lt;/item&gt;
&lt;item&gt;
&lt;womListText&gt; It is necessary to edit the &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;EscapedNoFormatText&gt;DataSource&lt;/EscapedNoFormatText&gt;&lt;/TextileStrong&gt;&lt;womListText&gt;  of the &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;EscapedNoFormatText&gt;DefaultConnection&lt;/EscapedNoFormatText&gt;&lt;/TextileStrong&gt;&lt;womListText&gt; in the web.config file so that it points to the correct Sql locator for the server&lt;/womListText&gt;&lt;/item&gt;
&lt;item&gt;
&lt;womListText&gt; Do not change the &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;EscapedNoFormatText&gt;AttachDbFilename&lt;/EscapedNoFormatText&gt;&lt;/TextileStrong&gt;&lt;womListText&gt;, of the &lt;/womListText&gt;&lt;TextileStrong&gt;&lt;EscapedNoFormatText&gt;InitialCatalog&lt;/EscapedNoFormatText&gt;&lt;/TextileStrong&gt;&lt;womListText&gt; values&lt;/womListText&gt;&lt;/item&gt;
&lt;item&gt;
&lt;womListText&gt; Update the Authentication Settings in IIS Manager so that they match the dialog below&lt;/womListText&gt;&lt;/item&gt;&lt;/list&gt;

&lt;Para&gt;&lt;WikiImage&gt;/LynxWiki/Attachments/upload/images/AuthenticationSetting.png&lt;/WikiImage&gt;&lt;/Para&gt;
&lt;Header level="2"&gt;
&lt;womHeaderText&gt;Other Configuration Steps&lt;/womHeaderText&gt;&lt;AnchorText&gt;_8_Other_Configuration_Steps&lt;/AnchorText&gt;&lt;/Header&gt;&lt;list type="ordered"&gt;&lt;item&gt;
&lt;womListText&gt; Update the Output Caching settings to match the entries below&lt;/womListText&gt;&lt;/item&gt;&lt;/list&gt;

&lt;Para&gt;&lt;WikiImage&gt;/LynxWiki/Attachments/upload/images/OutputCaching.png&lt;/WikiImage&gt;&lt;/Para&gt;
&lt;/WomDocument&gt;
</body>
</topicVersion>